dialog: Mark gtk_dialog_get_action_area as deprecated

Direct access to the action area by applications makes it much more
difficult to make changes to GtkDialog. Therefore, deprecate this
function.

diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index 57eeb4398e98378b6747bc5ca87bca33175243d9..d5a54a06e00aedccdf9a28e83861614ebca772cc 100644 (file)
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -1524,10 +1524,13 @@ gtk_dialog_buildable_custom_finished (GtkBuildable *buildable,
  *
  * Returns the action area of @dialog.
  *
- * Returns: (transfer none): the action area.
+ * Returns: (transfer none): the action area
  *
  * Since: 2.14
- **/
+ *
+ * Deprecated:3.12: Direct access to the action area
+ *   is discouraged; use gtk_dialog_add_button(), etc.
+ */
 GtkWidget *
 gtk_dialog_get_action_area (GtkDialog *dialog)
 {

diff --git a/gtk/gtkdialog.h b/gtk/gtkdialog.h
index 641b4501eab3f1dd1dd1f8ed15d42e2b9aea2116..1742985e8a4526bdd04e5ceafc16fbf5883dda54 100644 (file)
--- a/gtk/gtkdialog.h
+++ b/gtk/gtkdialog.h
@@ -188,7 +188,7 @@ void gtk_dialog_response           (GtkDialog *dialog,
 GDK_AVAILABLE_IN_ALL
 gint gtk_dialog_run                (GtkDialog *dialog);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_10
 GtkWidget * gtk_dialog_get_action_area  (GtkDialog *dialog);
 GDK_AVAILABLE_IN_ALL
 GtkWidget * gtk_dialog_get_content_area (GtkDialog *dialog);